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DFILE" 
A Diskette Directory Maintenance Program For North Star DOS 


(C) DYNACOMP, Inc., Pittsford, N.Y. 14534 


Summary 


DFILE is a machine language disk utility program which permits the user to 
build, maintain and use a North Star DOS master file directory. DFILE is 
fast, easy to use and well documented. 


Genera | Operation 


The owner of a Z-80 or 8080 microcomputer system with a North Star disk 
controller can now employ DFILE to keep track of all the programs on the 
various diskettes which tend to accumulate. For example, he may request 
the location of all copies of a particular file, thus eliminating the chore 
of searching through a stack of diskettes. 


With DFILE, you first invest a small amount of time organizing the stack of 
diskettes, assigning a unique ID to each diskette and building a master file 
of all the programs and files. The Appendix contains a sample to illustrate 
the selections available with DFILE. 


OFILE is an 8080 machine language program which provides North Star DOS diskette 
file name library maintenance functions. It is 6 kilobytes in length and 
executies at either 2A00H or 2D00H (two versions). Both versions will handie 
single/double density diskettes, either single or double sided. 


The library file is named DFIL and 1s contained on the "system" diskette. 
Fach user diskette recorded in DFIL must have a unique 4-digit identifier. 
DFIL is created by placing each user diskette in the drive and selecting 
DFILE's Add Disk Directory function. You may later probe DFIL to obtain 
information concerning a particular file name or a particular user diskette. 
Entries may be deleted, updated or commented as desired. 


DFIL must be created as a 256 sector file on the DFILE system diskette. If 

DFIL is greater than 256 sectors, then only the First 256 will be used. If 

DFIL is less than 256 sectors, a "not-found" message will occur and no access 

to DFIL will be possible. In single disk drive systems the program will allow 
removal of the system disk when a diskette directory is to be accessed (e.g., 
building the library file). When DFIL 1s used on a single drive system, a 
warning message prompts for replacement of the system diskette. Multiple drive 
systems may be customized to maintain the system diskette on any specified drive 
and use any other specified drive for diskette directory access. 


“Program code (C) 1980 by Daniel B. West, North Hollywood, California 
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DFILE interfaces to the North Star DOS routines for its disk and terminal 
communications. A Control-C from the keyboard during any input will result 
in,an immediate jump to the DOS reentry point. A Control-C from the key- 
board during DFILE search operations will abort the search and return to the 
base menu. The program is menu driven with the base menu containing the 
KOMONG 8 selections. 


— 


x | List Disk Directory: The directory on the user diskette is read 
| and displayed on the terminal in a format similar to the DOS "LI" 
display. 
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| ) Add Comments to DFIL Entry: The file name entry desired is read 
— from DFIL and displayed. You may enter a 1 to 7 character comment 
which is added to the entry and rewritten to DFIL. 


3) Delete File Entry From DFIL: The file name entry desired is read 
from DFIL and displayed. If requested, the entry is deleted from 
. DFIL. 


4) List DFIL: DFIL is accessed sequentially with each entry displayed. 
See the next section (Hashed Files). 


4 
| 
5) List All Entries For File Name X . All entries in DFIL whose file 
| name matches the request are displayed. 


i) List Al] Entries For Disk ID X. The file is searched sequentially 
and all entries whose Disk ID's match the request are displayed. 


Add Disk Directory To DFIL: The directory from the user diskette 
is accessed and all entries except those discussed below are added 
to DFIL. File names of the reserved "DOS" sectors are not added. 
Files which reside at start address O are not added. The user 
responds to a Y/N prompt for each file name entry to be added. 


SL 
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8) Initialize DFIL: A newly created DFIL is initialized with this operation. 
Also, if an existing DFIL is to be emptied of all entries, this selection 
is executed. The entire file is overwritten. 


Hashed Files 


A OL, 
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DFIL contains a maximum of 2048 file name entries for single density or 4096 
fori double density systems. Fach entry is located in the file by "hashing" the 
fille name to obtain the relative sector number where the file name search is to 
oo The hashing algorithm adds all characters of the file name, modulo 256. 
Thi 

time. 


results in menu selections 2, 3, 5 and 7 operating with a very short response 
The entries, however, are distributed oddly througnout DFIL as a result. 

Meru selection 4 displays entries in this seemingly random order. Menu selection 

6 must search the entire DFIL for all possible entries which match in Disk ID 

andi therefore will require a minute or So to complete. However, results are 

pr ihted as they are obtained. 
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Due to the peculiarities of hashed files, it is recommended that the file 
should not have more than 1800 entries to prevent entry search time from 
becoming noticeably greater than a few seconds. If you have more than 180 
diskettes with an average of 10 file names per diskette, it is suggested 

that you divide the diskette pool into two logical partitions and use 2 
separate system diskettes with separate DFIL inventories. For double density 
DFIL systems, the above values should be doubled. 


User Disk Identification 


The Disk ID must be composed of 4 ASCII-printable characters, of which the 
first character must NOT be a blank or a zero. 


A suggestion: Assign Disk ID's with a letter followed by 3 numeric digits. 

The letter defines the diskette usage: M = Master files; W = Working files; 

B = Backup files. Menu selection 5 then results in a display of all copies of 

a particular file name and at a glance you can then verify that you have at 

least one master and one backup copy of an important file. Of course, this 
requires that you spend some time moving files around on the diskettes to arrive 
at the above logical partitioning. Since this verification process is efficient, 
you do not need to maintain large numbers of copies of a file and can maintain 
better control of the process of updating a file to newer versions. 


Disk Updating 


DFILE does not perform write operations to user diskettes. The only possible 
way a user diskette may be harmed is if that diskette contains the file name 
DFIL in its directory and you have placed it in the system drive (see DFILE 
Customizing Table) when DFILE wishes to access DFIL. On finding the DFIL file 
name, the program may then perform output to the user diskette anywhere in the 
256 sector area which it has mistakenly confirmed to be DFIL. The obvious 
solution to this problem is to use the file name DFIL only on the DFILE system 
disk, and to cover the "protect" notches on the user diskettes. 


Customizing DFILE 


The following table lists the various assignments of the first 40 bytes of DFILE. 
Modifying these values results in a customized program. Note that all values are 
in either decimal or hex and the user must be careful to convert the decimal 
values to hex prior to patching. The location values are for the 2A00H version 
of DFILE and the same relative offsets for the 2DOOH version. 
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DFILE Customizing Table 


Location Label Default Value Description 
2A00H START C3 XX XX Jump to start of program 
2A03H DOUT C3 OD 20 To DOS terminal output (Default: North Star DO 
2A06H DINP C3 10 20 To DOS keyboard input (Default: North Star DOS 
2A09H DCLR C9 00 00 To user screen clear (Default: North Star DOS 
2A0CH DCOM C3 22 20 To DOS disk command (Default: North Star DOS) 
2A0FH DLOOK C3 1C 20 To DOS directory search (Default: North Star D 
2A12H DOS ` C3 28 20 To DOS reentry (Default: North Star DOS) 
2A15H CONTC C3 16 20 To DOS status check (Default: North Star DOS) 
2A18H DRTYN 02 * Drive # for user disks 
2A19H DFNUM 01 Drive 4 for disk containing DFIL (system) 
2A1AH DFNAM "DFIL,1" DFIL file name 
2A25H CKDOS Ignore DOS file name 
2A26H CKZRO 0 Ignore files at sector 0 
2A27H PSIZE 16D (10H) Terminal page size 
2A28H RUBO 5FH Input delete character 
2A29H ECHOR 5FH Echoed delete character 
ZAZAH OPORT 0 Output port number 
2A2BH IPORT 0 Input port number 


Directory Display 


The display of a directory entry is similar to the DOS LIst display but with two 
exceptions. The file length is always the number of sectors and not the number 
of 256 byte blocks. In other words, a file of 512 bytes in single density will 
display a length of 2, and in double density it will display a length of 1. Also, 
the type field for a single density file will display as 0 to 127. For a double 
density file it will display as 128 to 255. For example, à BASIC program of type 
2 in double density will be displayed as type 130. 





Notes 


1) DFILE expects all DOS routines to meet the North Star interface 
requirements. 


2) The only exit from DFILE is a Control-C jump to DOS reentry. 
3) DFIL must be 256 contiguous sectors on the system diskette. 


4) PSIZE (the number of lines on the console display screen) may range 
from 5 to 255D. 


5) DFNAM must be an 11 ASCII character file (starting at 2A1AH) with 
file (1 to 8 characters) followed by ",D" (D = drive #) followed by 
at least one ASCII space (20H). If you change the name from DFIL, 
the menu and prompt messages will still continue to refer to the 
master file as DFIL. 


Notes (continued) 
6) DRTYN and DFNUM should contain a value of 1, 2, 3 or 4. 


7) RUBO should contain the hex equivalent of the ASCII value the 
DINP routine provides when a "delete char" function is entered. 


3) ECHOR should contain the ASCII value which the DOUT routine is to 
receive when the "delete char" is echoed back to the terminal. 


9) If CKDOS is non-zero, file name entries of "DOS" will be included. 


10) If CKZRO is non-zero, files which are defined to start at sector 
0 will be included in DF IL. 





11) If DRTYN and DFNUM are equal (for single drive users) then some 
removal and reinsertion of the system diskette will be required. 
Any time DFIL is to be accessed, the directory is checked to 
verify the presence of DFIL and to obtain its start address. 

The message "DFIL NOT FOUND ON DRIVE - RETRY? Y/N" should be 
used as a prompt to remove the user diskette and insert the 
system diskette. Respond "Y" and the program execution will 
continue. If the response is other than "Y", a jump to the DOS 
reentry is made. If the prompt message continues to occur, then 

the DFIL length is not 256 sectors or larger. 
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selection 7 (add user disk directory to DFIL) will add any new 
file names and will update any which are present on DFIL from a 
previous operation. However, if a file name has been deleted 

from the user disk since the previous operation, it will not be 


deleted from DFIL. The user must use selection 3 to delete any 
such holdover file names from DFIL. 


13) Immediately after DFILE loads and initialization is complete you 

are prompted for the current date. This date is to be entered as 

a 6 digit numeric value. For example, for 3 April 1980, you should 
enter 040380. 


14) If you wish DFILE to clear the console screen at program initializa- 
tion, place a jump to your screen clear routine at DCLR. No registers 


will be set up by this call and no registers need be protected by your 
routine. 


DYNACOMP has taken great care to ensure that the software which you have purchased 
is free of defects and that the documentation iS complete and clear. In the 


improbable event that you should experience difficulties, please feel free to 
contact DYNACOMP. 


Sample session using DFILE... 


PLEASE ENTER 6 DIGIT DATE - MMODYY 
072550 


TLE MAINTENANCE PROGRAM 07/25/89 
- LIST DISK DIRECTORY 

- ADD COMMENTS TO DFIL ENTRY 

- DELETE FILE ENTRY IN DFIL 

LIST DFIL 

- LIST ALL ENTRIES FOR FILENAME X 

- LIST ALL ENTRIES FOR DISKID A 

- ADD DISK DIRECTORY TO DFIL 

- INITIALIZE DFIL 


ny Cl .b O F3 e O 
"11 
| 


ENTER SELECTION * : 1 
DO YOU WISH PAUSE AT PAGE INTERVALS? Y/N 


N 
PLEASE INSERT DESIRED DISK IN DRIVE, PRESS RETURN 


DISK FILENAME START LENGTH TYPE EXECUTE DATE 


enan comm avè esee sunt (MOS (009 ne ewes «ban onn es s. s. 4... “s‏ הפמט 


DFILZA00 004 024 001 2400 
DFIL2D00 025 024 001 0 
FINDIT.C 052 020 002 
FINDIT ide 036 002 
DFILE.S 182 085 004 


NUMBER OF 256 EYTE ELOCKS IN USE = 265 
IF DOS FILENAME IS IGNORED» ADD DCS LENGTH TO ABOVE 


END OF DISPLAY - - - PRESS RETURN FOR MENU 
DFILE MAINTENANCE PROGRAM 07/25/80 
1 - LIST DISK DIRECTOR? 
2 — ADD COMMENTS TO DFIL ENTRY 
2 - DELETE FILE ENTRY IN Or IL. 
4 - LIST DFiL 
= ~ LIST ALL ENTRIES FOR FILENAME X 
å - LIST ALL ENTRIES FOR DISKID X 
7 - ADD DISK DIRECTORY TO DFIL 
8 - INITIALIZE Driv 


ENTER SELECTION + + 7 


PLEASE ENTER 4 CHARACTER DISK ID 
M209 
PLEASE INSERT DESIRED DISK IN DRIVE, FRESS RETURN 


COMMENTS 


DISK FILENAME START 
DFILZAÜDO 004 G24 
ADO THIS ENTRY? Y/N Y 
INTER NEM COMMENTS» 1 TO. 7 
DFILZD09 028 G24 
ADD THIS ENTRY? Y/N Y 


ENTER NEW COMMENTS» 1 TO 7 
FINDIT.C 052 056 
ADD THIS ENTRY? Y/N Y 
ENTER NEW COMMENTS» 1 TO 7 
FINDIT 102 080 
ADD THIS ENTRY? Y/N Y 
ENTER NEX COMMENTS» 1 TO 7 
DFILE.S 182 083 
ADD THIS ENTRY? Y/N Y 
ENTER NEW COMMENTS? 1 TO 7 
NUMBER OF 256 BYTE BLOCKS 
IF DOS FILENAME IS IGNORED 
END OF DISPLAY - — 7 FRESS 


DFILE MAINTENANCE PROGRAM 
- LIST DISK DIRECTORY 
— ADD COMMENTS TO DFIL ENTRY 


= DELETE FILE ENTRY 
IST DFIL 

- LIST ALL ENTRIES F 
- LIST ALL ENTRIES F 
- ADD DISK DIRECTORY 
- INITIALIZE % 


co Os OA WDE 
i 


ENTER SELECTION + | 5 
DO YOU WISH FAUSE AT PAGE 
N I 


PLEASE ENTER FILE NAME? 1 
DFILE.S 


DISK 


opm eons veep son 


FILENAME 


even asou = 


fi 
a 
-4 
T> 
רב‎ 
~4 


LEN 


save conn canna wave s... -m cose ₪ 


LENGTH TYPE EXECUTE DATE 


COMMENTS 


wren 1000 2000 pos even 05:00 cun am enan .... toon 09505 s... 0000 ao 0040 0950 2900 we. spen s. anne seso 1000 soso 


001 26006 


CHARACTERS V3.2 
001  2D00 


CHARACTERS V3.2 
002 


CHARACTERS COMFRES 
002 


CHARACTERS VS+£ 
004 


CHARACTERS SOURCE 
IN USE = Z263 

, ADD DOS LENGTH TO AECVE 
RETURN FOR MENL 


07/23/80 
IN DFIL 
OR FILENAME X 


OR DISKID X 
TO DFIL 


INTERVALST 


Y/N 


TO 8 CHARACTERS 


CTH TYPE 


EXECUTE DATE 


ew cher on avan ouve vwe oua wae e) ao c9 


COMMENTS 


vann «am coos con men ren zo even vnb «anv s... 


PJ 





End ד >" פארה‎ 
q RR 


! 


M100 DFILE.S 204 065 004 04/26/80, V3.2 
M107 DFILE.S 121 043 132 | 04/27/80\ V3.2 
M200 DFILE.S 182 085 004 07/25/80 | SOURCE 
. h 
i 
END OF DISPLAY - - - FRESS RETURN FOR MENU ú 
| | 
DFILE MAINTENANCE PROGRAM 07/25/80 | 
1 - LIST DISX DIRECTORY å 
2 - ADD COMMENTS TO DFIL ENTRY 
3 - DELETE FILE ENTRY IN DFIL | 
4 - LIST DFIL 
5 - LIST ALL ENTRIES FOR FILENAME X | 
à - LIST ALL ENTRIES FOR DISKID X | 
7 - ADD DISK DIRECTORY TO DFIL x 
8 - INITIALIZE DFIL : 
i 
ENTER SELECTION + 5 6 | 
PLEASE ENTER 4 CHARACTER DISK ID 
M200 | | 
DO YOU WISH FAUSE AT FAGE INTERVALS? Y/N | 
N ' 
DISK FILENAME START LENGTH TYPE EXECUTE DATE COMMENTS 
M200 DFILE.S 182 085 004 07/25/80 SOURCE 
M200 FINDIT.C 052 050 002 07/25/80 COMPRES 
M200 DFILZADO 004 024 001 2400 07/25/80 V3.2 
M200 DFILZDO9 028 024 001 2000 07/25/80 V3.2 
M200 FINDIT 102 080 002 07/25/80 V3.2 


NUMBER GF 256 BYTE BLOCKS IN USE = 263 
IF DOS FILENAME IS IGNORED»; ADD DOS LENGTH TO ABOVE 
END OF DISFLAY - - - FRESS RETURN FOR MENU 


ILE MAINTENANCE PROGRAM 07/23/50 
- LIST DISK DIRECTORY 

- ADD COMMENTS TO DFIL ENTRY 

- DELETE FILE ENTRY IN DFIL 

LIST DFIL 

- LIST ALL ENTRIES FOR FILENAME X 

- LIST ALL ENTRIES FOR DISKID X 

- ADD DISK DIRECTORY TO Dr LL 

- INITIALIZE DFIL 


ono WLW HE E2 
1 





PLEASE ENTER FILE NAME» 1 TO 8 CHARACTERS 

DFILE.S 

PLEASE ENTER 4 CHARACTER DISK 1D 

M250 

DISK FILENAME START LENGTH TYFE EXECUTE DATE COMMENTS 
M200 DFILE.S 182 083 004 07/25/80 SOURCE 


DELETE THIS ENTRY? Y/NY 


DFILE MAINTENANCE PROGRAM 07/25/80 
{ - LIST DISK DIRECTORY 

- ADD COMMENTS TO DFIL ENTRY 

- DELETE FILE ENTRY IN DFIL 

- LIST DFIL 

LIST ALL ENTRIES FOR FILENAME X 

- LIST ALL ENTRIES FOR DISKID X 

- ADD DISK DIRECTORY TO DFIL 

- INITIALIZE DFIL 


ONG dh DN 
| 


ENTER SELECTION + + Š 
DO YOU WISH FALSE AT PAGE INTERVALS? Y/N 
N š 


PLEASE ENTER FILE NAME» 1 TO 8 CHARACTERS 
DFILE.S 


DISK FILENAME START LENGTH TYPE EXECUTE DATE COMMENTS 


Mi00 DFILE.S 204 035 004 04/26/80 V3.2 
MiC7 DFILE.S 121 043 Ios 04/27/80 V3.2 


END OF DISPLAY - 7 - PRESS RETURN FOR MENU 
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